home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 2 / Meeting Pearls Vol. II (1995)(GTI - Schatztruhe)[!].iso / Pearls / comm / EazyBBS / contrib / EazyLog_17.lha / EazyLog_V1.7 / EazyLog.dok < prev    next >
Text File  |  1994-08-14  |  11KB  |  297 lines
  1.  
  2.                                  EazyLog V1.7
  3.                                  ~~~~~~~~~~~~
  4.  
  5.                         © 1994 by Thomas Patschinski
  6.  
  7.  
  8.  
  9. Was ist EazyLog:
  10. ~~~~~~~~~~~~~~~~
  11.  
  12. EazyLog ist ein Statistik Programm für das Transferprotokol von EazyBBS. Es
  13. wertet die am meisten gedownloadeten Files und die am meisten beschriebenen
  14. Boards aus.
  15.  
  16. EazyLog benötigt EazyBBS ab Version 2.12.
  17. EazyLog kann auch von der Shell aufgerufen werden.
  18.  
  19.  
  20. Installation von EazyLog:
  21. ~~~~~~~~~~~~~~~~~~~~~~~~~
  22.  
  23. Falls noch kein Ordner für Statistik Programme für EazyBBS besteht, sollte
  24. ein Ordner (z.B. mb:Progs wovon ich im weiteren ausgehe) erstellt werden.
  25.  
  26. Dort müssen alle Files die mit EazyLog beginnen reinkopiert werden. Das
  27. EazyLog.dok natürlich nur auf wunsch.
  28.  
  29. Die Files 14 bis 17 im Ordner UserProgramme im Archiv sind Beispiele wie
  30. EazyLog als Userprogramm aufgerufen werden kann. Dabei wird davon ausgegangen
  31. das sich das Config File sowie die beiden Header Dateien im Ordner mb:Progs
  32. befinden. Programm 14 ist für die Top Files, Programm 15 für die Top Boards
  33. und Programm 16 für die AreaStat anzeige der Area Amiga/Utilities Configuriert.
  34.  
  35. Das Programm 17 ist für die Userstat Anzeige. Dabei wird auf Locale Variable
  36. $EazyUsername zurückgegriffen. Somit kann sich jeder User seine
  37. Up- und Downloads anzeigen lassen.
  38.  
  39.  
  40. Aufruf von EazyLog:
  41. ~~~~~~~~~~~~~~~~~~~
  42.  
  43. Template: ?/S,C=Config/K,L=Log/K,Buffer/K/N,F=Files/S,B=Boards/S,AreaStat/K,UserStat/K
  44.  
  45. ?         Zeigt eine Copyright hinweis und die Schablone (Template an).
  46.  
  47. Config    Bestimmt die zu benutzende Config Datei. Wird das Configfile nicht
  48.           angegeben so wird Das file PROGDIR:EazyLog.Config versucht zu laden.
  49.           Konnte das auch nicht gefunden werden oder ist der übergebene
  50.           Filename falsch, so werden interne Defaut werte genommen. Siehe
  51.           die Kommentare im Config-File.
  52.  
  53. Log       Wird ein Filename angegeben so wird jeder aufruf von EazyLog darin
  54.           mitprotokoliert. Es wird das Datum, die Zeit, der User,
  55.           das verwendete Config-Files und die art der Ausgabe protokolliert.
  56.  
  57. Buffer    Legt die größe des Buffers der gepufferten I/O fest. Funktioniert
  58.           aber laut V40 Autodocs erst ab V40. Da diese Routine in V39 Disabled
  59.           ist. Default 4096 Bytes.
  60.  
  61. Files     Top Files Ausgeben.
  62.  
  63. Boards    Top Board Ausgeben.
  64.  
  65. AreaStat  Bestimmt die Auszugebende Area (ähnlich wie Status Xfer aus EazyBBS).
  66.           Diese Ausgabe ist normalerweise für Sysops und Verwalter gedacht.
  67.           Damit kann man leicht die Aktivitäten einer bestimmten File-Area
  68.           ersehen.
  69.  
  70. UserStat  Bestimmt den User dessen Uploads/Downloads ausgegeben werden sollen.
  71.           Diese Ausgabe sollte wegen des Datenschutzes nur Sysops ermöglicht
  72.           werden. Oder am besten das beigelegte Userprogramm 17 benutzen. 
  73.  
  74.  
  75. Die reihenfolge der Ausgaben ist AreaStat -- UserStat -- Files -- Boards.
  76.  
  77. Ohne eine angabe von Files, Boards, AreaStat oder UserStat wird keine Ausgabe
  78. erzeugt. Und das Logfile auch nicht durchsucht.
  79.  
  80.  
  81. Beispiel:
  82.  
  83. EazyLog Config=mb:Progs/EazyLog.Config_1 Files
  84.  
  85. oder
  86.  
  87. EazyLog Files Boards
  88.  
  89.  
  90. Das EazyLog.Config File:
  91. ~~~~~~~~~~~~~~~~~~~~~~~~
  92.  
  93. Folgende Keywords werden im Config File erkannt:
  94.  
  95. DaysAgo                         Wieviele Tag zurück berücksichtigen.
  96. Ports                           Liste der Ports die berücksichtigt werden
  97.                                 sollen, per Komma getrennt, max bis Port 31.
  98. LogName                         Kompletter Filename des TransferLog File.
  99. HiddenArea                      File Area die nicht in der Top File Liste
  100.                                 auftauchen soll. (Kann öfter angegeben werden)
  101. HiddenBoard                     Board das nicht in der Top Board Liste
  102.                                 auftauchen soll. (Kann öfter angegeben werden)
  103. TopFiles                        Anzahl der Files die auszugeben sind.
  104. FileIntro1st                    Einleitung für den Platz 1 der Top Files.
  105. FileIntroNext                   Einleitung für alle übrigen Plätze.
  106. FileHeader                      Filename des Headers für die Top Files.
  107. FileFooter                      Filename des Footers für die Top Files.
  108. ShowFileHeader                  File Header anzeigen.
  109. ShowFileFooter                  File Footer anzeigen.
  110. TopBoards                       Anzahl der Boards die auszugeben sind.
  111. BoardIntro1st                   Einleitung für den Platz 1 der Top Boards.
  112. BoardIntroNext                  Einleitung für alle übrigen Plätze.
  113. BoardHeader                     Filename des Headers für die Top Boards.
  114. BoardFooter                     Filename des Headers für die Top Boards.
  115. ShowBoardHeader                 Board Header anzeigen.
  116. ShowBoardFooter                 Board Footer anzeigen.
  117. TopAreaStat                     Anzahl auszugebenen Plätze.
  118. AraeStatIntro1st                Einleitung für den Platz 1 der AreaStat Liste.
  119. AreaStatNext                    Einleitung für alle anderen Plätze.
  120. AreaStatHeader                  Filename des Headers für die AreaStat Ausgabe.
  121. ShowAreaStatHeader              AreaStat Header anzeigen.
  122. UserStatHeader                  Filename des Headers für die IserStat Ausgabe.
  123. ShowUserStatHeader              UserStat Header anzeigen.
  124. TopUserStat                     Anzahl der Auszugebenen Files.
  125. SortUserStat                    Nach Filegröße Sortieren, oder die liste in
  126.                                 der reihenfolge lassen so wie sie im Logfile
  127.                                 auftauchen.
  128.  
  129. Für ShowXXXHeader und ShowXXXFooter kann yes,no,ja,nein als Parameter
  130. angegeben werden.
  131.  
  132. Parameter die Spaces, Tabs und/oder Kommas enthalten müssen in
  133. Anführungszeichen eingeschlossen sein. In Anführungszeichen kann \n für
  134. einen zeilenvorschub angegeben werden. Das \ Zeichen kann durch \\ erreicht
  135. werden.
  136.  
  137. Siehe auch das Beigelegte Config File.
  138.  
  139.  
  140.  
  141. Das EazyLog.Header_* File:
  142. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  143.  
  144. Die Files enthalten den Kopf der jeweiligen Ausgabe. Es können mittels
  145. % und einem Buchstaben Werte eingesetzt werden. Bis jetzt werden
  146. folgende unterstützt. Die groß/kleinschreibung ist egal.
  147.  
  148. %               Das % Zeichen selbst.
  149. v               Die Versions Nummer von EazyLog.       3 Zeichen lang.
  150. d               Das Datum und die Uhrzeit.            17 Zeichen lang.
  151. a               Anzahl der Tage die berücksichtigt
  152.                 wurden.                                3 Zeichen lang.
  153. s               Name der Area, nur bei AreaStat       31 Zeichen lang.
  154. u               Name des Users, nur bei UserStat      15 Zeichen lang.
  155.  
  156.  
  157. Das EazyLog.Footer_* File:
  158. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  159.  
  160. Die Files enthalten den Footer der jeweiligen Ausgabe. Es können mittels
  161. % und einer Zahl Werte eingesetzt werden. Bis jetzt werden
  162. folgende unterstützt.
  163.  
  164. %        Das % Zeichen selbst.
  165. 1        Gesamt Anzahl der Files/Messages die in dem Zeitraum liegen.
  166. 2        Anzahl der Files/Messages die angezeigt wurden.
  167. 3        Gesamt Anzahl der Ranks.
  168. 4        Anzahl der Ranks. Gleich mit "TopFiles","TopBoards"
  169.         aus dem Config File.
  170. 5        Anzahl der Ranks die nicht dargestellt wurden. (%3-%4)
  171.  
  172. Alle Zahlen sind 3 Stellig. Sollten es größere Zahlenwerte geben so erhöht
  173. sich die anzahl der Stellen entsprechend.
  174.  
  175.  
  176.  
  177. Der C Source Code:
  178. ~~~~~~~~~~~~~~~~~~
  179.  
  180. Der Source ist mit SAS/C zu Compilieren. Ausserdem wird zum linken die
  181. pools.lib von Michael Sinz benötigt.
  182.  
  183.  
  184.  
  185. Enthaltene Files:
  186. ~~~~~~~~~~~~~~~~~
  187.  
  188. EazyLog000               Länge 23420 Bytes
  189. EazyLog030               Länge 23348 Bytes
  190. EazyLog.dok              Länge 10981 Bytes
  191. EazyLog.Config           Länge  3062 Bytes
  192. EazyLog.Header_AreaStat  Länge   668 Bytes
  193. EazyLog.Header_UserStat  Länge   669 Bytes
  194. EazyLog.Header_TopFiles  Länge   606 Bytes
  195. EazyLog.Header_TopBoards Länge   606 Bytes
  196. EazyLog.Footer_TopFiles  Länge    48 Bytes
  197. EazyLog.Footer_TopBoards Länge    51 Bytes
  198. UserProgramme/14         Länge    62 Bytes
  199. UserProgramme/15         Länge    63 Bytes
  200. UserProgramme/16         Länge    81 Bytes
  201. UserProgramme/17         Länge   109 Bytes
  202. Src/EazyLog.c            Länge 55407 Bytes
  203. Src/SCOPTIONS            Länge   240 Bytes
  204.  
  205.  
  206.  
  207. History:
  208. ~~~~~~~~
  209.  
  210. V 0.1ß  - Nicht veröffentlichte Version.
  211.         - Nur die Anzeige der Top Files.
  212.  
  213. V 0.2ß  - Version für die Betatester.
  214.         - Der Top File Header jetzt als Externes File.
  215.  
  216. V 0.3ß  - Erste öffentliche Beta Version.
  217.         - Top Boards Auswertung implementiert.
  218.         - Eingabe Schablone überarbeitet.
  219.  
  220. V 1.0   - Benutzung kann jetzt in einem Logfile festgehalten werden.
  221.         - Die groß kleinschreibung bei den Keywords im Config File und
  222.           den Board Area Namen ist jetzt egal.
  223.  
  224. V 1.1   - Footer Text auf wunsch darstellbar.
  225.         - Footer Text als Externes Text File Editierbar.
  226.         - Header und Footer abschaltbar.
  227.  
  228. V 1.2   - Nach SAS/C umgesetzt. (mit V6.3 Compiliert)
  229.         - ab V40 wird ein 4096 Byte Puffer zum einlesen des Transfer.Log und
  230.           des Config Files, sowie zum schreiben des eigenen Logfiles benutzt.
  231.           Dadurch wir nur ab und zu auf die Platte zugegriffen.
  232.         - Jetzt sind alle Alloc/FreeVec Aufurfe durch MemoryPool Aufrufe
  233.           aus einer Linker Library erstezt. Diese Linker Library hat eigene
  234.           Memory Pool Routinen, benutzt aber ab V39 die aus der exec.libraray.
  235.  
  236. V 1.3   - Neue Ausgabe: AreaStat
  237.         - Berechtigung der Programm ausführung für verschiedene User kannn ein
  238.           oder ausgeschaltet werden.
  239.         - Default Configfile wird jetzt in PROGDIR: gesucht.
  240.         - \n nun innerhalb von "" im Configfile möglich. Für ForbiddenText.
  241.         - Neue Ausgabe: UserStat
  242.  
  243. V 1.4   - Bug entfernt: HiddenAreas und HiddenBoards wurden nicht
  244.           berücksichtigt. Ist in der V1.3 entstanden.
  245.  
  246. V 1.5   - EazyLog an das Transferlog von EazyBBS V2.16 angepasst. Läuft auch
  247.           noch mit den vorgängerversionen.
  248.  
  249. V 1.6   - Ausgabe bei Userstat überarbeitet, letzte Ziffer der Zeit wurde
  250.           abgeschnitten.
  251.  
  252.         - Bei der UserStat Ausgabe gibt es jetzt auch eine Header Ausgabe.
  253.  
  254.         - Gesamt Länge bei Userstat wird jetzt mit ausgegeben.
  255.  
  256.         - Im EazyLog Logfile wird jetzt festgehalten ob der Aufrufer
  257.           berechtigt war EazyLog mit der Configuration zu Starten.
  258.  
  259.         - UserStat ausgabe wurde nicht im Logfile protokolliert.
  260.  
  261. V 1.7   - Es wurde immer im Logfile "UserStat" angezeigt.
  262.  
  263.         - C Source beigefügt.
  264.  
  265.         - Mit SAS/C 6.51 Compiliert.
  266.  
  267.         - Versionen für 68000er und 68030er beigefügt.
  268.  
  269.  
  270.  
  271. Der Autor:
  272. ~~~~~~~~~~
  273.  
  274.      Thomas Patschinski
  275.      Formerweg 19
  276.      12355 Berlin
  277.  
  278.      Tel. 030/6614590
  279.  
  280.      E-Mail: thomas@moonmbx.in-berlin.de
  281.      CI$:    100043,3473
  282.  
  283.      Sowie in der Moonbase BBS Tel.: 030/6613791 an den User Bf
  284.  
  285. Bug-Reports und vorschläge zu EazyLog sind immer willkommen. E-Mail anfragen
  286. werden am schnellsten beantwortet.
  287.  
  288.  
  289. Disclaimer:
  290. ~~~~~~~~~~~
  291.  
  292. EazyLog is Copyrighted by Thomas Patschinski.
  293. EazyLog is Freely Distributable if no changes are made.
  294.  
  295. EazyLog darf auf PD-Serien, Mailboxen, auf ftp Servern und auf
  296. Shareware/PD CD's Kopiert werden.
  297.